home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / catD / scsi_free.z / scsi_free
Encoding:
Text File  |  2001-04-17  |  3.0 KB  |  67 lines
  1.  
  2.  
  3.  
  4. ssssccccssssiiii____ffffrrrreeeeeeee((((DDDD3333XXXX))))                                                  ssssccccssssiiii____ffffrrrreeeeeeee((((DDDD3333XXXX))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      scsi_free - release communication channel to host adapter driver
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ttttyyyyppppeeeessss....hhhh>>>>
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ssssccccssssiiii....hhhh>>>>
  14.  
  15.      vvvvooooiiiidddd
  16.      ((((****ssssccccssssiiii____ffffrrrreeeeeeee))))(((( vvvveeeerrrrtttteeeexxxx____hhhhddddllll____tttt _l_u_n__v_h_d_l,,,,
  17.                      vvvvooooiiiidddd ((((****_c_a_l_l_b_a_c_k__f_u_n_c_t_i_o_n))))((((vvvveeeerrrrtttteeeexxxx____hhhhddddllll____tttt,,,, cccchhhhaaaarrrr ****))))))));;;;
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      The host adapter _s_c_s_i__f_r_e_e function is used to terminate a connection
  21.      between a SCSI device driver and the host adapter driver.
  22.  
  23.      There is no kernel object called scsi_free; rather, there is a pointer to
  24.      each host adapter's scsi_free function in the sci_free field of the
  25.      scsi_ctlr_info structure, which is attached to the vertex corresponding
  26.      to the host adapter.
  27.  
  28.      _l_u_n__v_h_d_l is the device vertex, as given to _s_c_s_i__a_l_l_o_c to open the
  29.      channel.  The _c_a_l_l_b_a_c_k__f_u_n_c_t_i_o_n argument must be the same as that given
  30.      to _s_c_s_i__a_l_l_o_c.
  31.  
  32. NNNNOOOOTTTTEEEESSSS
  33.      _s_c_s_i__a_l_l_o_c is stored as a function pointer in the scsi_ctlr_info_t
  34.      structure, which is associated with the scsi host adapter vertex in the
  35.      hwgraph.  The information structure in the scsi target vertex also has a
  36.      pointer to the scsi_ctlr_info_t of the host adapter that the target is
  37.      connected to.  Given a _l_u_n__v_h_d_l (vertex handle of the device) the
  38.      scsi_free function can be called as follows:
  39.  
  40.               scsi_lun_info_t *scsi_lun_info;
  41.             ...
  42.               scsi_lun_info = scsi_lun_info_get(lun_vhdl);
  43.               SLI_FREE(scsi_lun_info)(lun_vhdl,callback_function);
  44.  
  45.  
  46. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  47.      comments in /usr/include/sys/scsi.h, hwgraph.intro(D4X), scsi_alloc(D3X),
  48.      scsi_command(D3X), scsi_free(D3X), scsi_info(D3X), scsi_ioctl(D3X),
  49.      scsi_abort(D3X), SCSI chapter of the IRIX Device Driver Programmer's
  50.      Guide
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.